@thi.ng/errors

Custom Error Classes

This feature allows you to create and use custom error classes like IllegalArgumentError and IllegalStateError to handle specific error conditions in your code.

const { IllegalArgumentError, IllegalStateError } = require('@thi.ng/errors');

function checkAge(age) {
  if (age < 0) {
    throw new IllegalArgumentError('Age cannot be negative');
  }
  if (age > 120) {
    throw new IllegalStateError('Age seems unrealistic');
  }
  return 'Age is valid';
}

try {
  console.log(checkAge(-5));
} catch (e) {
  console.error(e.message);
}

Predefined Error Types

The package provides predefined error types like UnsupportedOperationError to handle common error scenarios in a standardized way.

const { UnsupportedOperationError } = require('@thi.ng/errors');

function notImplemented() {
  throw new UnsupportedOperationError('This operation is not supported');
}

try {
  notImplemented();
} catch (e) {
  console.error(e.message);
}

Error Wrapping

The wrapError function allows you to wrap existing errors with additional context, making it easier to debug and understand the root cause of errors.

const { wrapError } = require('@thi.ng/errors');

function riskyOperation() {
  try {
    throw new Error('Something went wrong');
  } catch (e) {
    throw wrapError(e, 'Risky operation failed');
  }
}

try {
  riskyOperation();
} catch (e) {
  console.error(e.message);
}